home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / bbsutil / mnet210.zip / MNET.DOC < prev    next >
Text File  |  1994-06-29  |  37KB  |  737 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.     MNET v2.10  -   Mail Packet Conversion Utility for Node Operation
  7.                     on a QWK-based Mail Network
  8.  
  9.               Copyright (C) 1992-94 Newark Connections/MAKAI Software
  10.                                All rights reserved.
  11.  
  12.     ==========================================================================
  13.  
  14.     Before we can get started, we need to run through the now-familiar
  15.     notices and disclaimers:
  16.  
  17.        MNET is copyrighted software from MAKAI Software.  It is not public
  18.        domain or freeware, but rather is released as uncrippled shareware.
  19.        You are free to try MNET to see if it meets your needs, but if you
  20.        decide to continue to use MNET, you are required to register the
  21.        software with MAKAI Software.  See Appendix A of this file, or the
  22.        separate file REGISTER.DOC, included with this package.
  23.  
  24.        While we have attempted to produce a useful piece of bugfee software
  25.        (which runs quite well on our system here, by the way), MNET is
  26.        released as-is with no guarantees of performance.  YOU USE MNET AT YOUR
  27.        OWN RISK, and the authors will not be held accountable for any damages
  28.        resulting from its use.
  29.  
  30.        The MNET package (MNET210.ZIP) may be distributed freely (in unmodified
  31.        form) to friends, associates, and bulletin boards.  Re-archiving into
  32.        your favorite format (ARJ, LZH, etc) is permitted, provided that the
  33.        entire package (and all documentation) is included in the re-archiving
  34.        process, and no files are modified.  If you received this package in
  35.        some other format than MNET210.ZIP, or the .ZIP file does not have Chip
  36.        Morrow's or Doug Wilson's -AV verification, then you did not receive an
  37.        original copy.  Please see the appendices on how to obtain a copy of
  38.        MNET directly from a MAKAI Software distribution site.
  39.  
  40.        If you are a registered user of MNET, do *NOT* distribute the
  41.        registration code that you received from us.  This is your own personal
  42.        registration, and is not for distribution.
  43.  
  44.        If you are a shareware distributor/dealer, a nominal disk copying and
  45.        handling fee is permitted.
  46.  
  47.     And one more necessary announcement:
  48.  
  49.       ****************************************************************
  50.       * IMPORTANT NOTE:  Many established networks, such as FIDONet, *
  51.       * RBBSNet, and RIME do not permit unauthorized distribution of *
  52.       * their message bases.  ** DO NOT ** use MNET to transfer such *
  53.       * conferences without first obtaining permission from proper   *
  54.       * authorities.                                                 *
  55.       ****************************************************************
  56.                                 MNET v2.10 QWK-Network File Conversion Utility
  57.                                                                     - Page 2 -
  58.  
  59.     ----------------------------------------------------------------------
  60.                                   FOREWARD
  61.     ----------------------------------------------------------------------
  62.  
  63.     Some years ago Mark "Sparky" Herring devised a system for creating packets
  64.     of mail from electronic bulletin boards for the purpose of downloading and
  65.     reading/replying offline.  The "QWK" format he established has become a
  66.     standard used by many offline messaging systems.  Although originally
  67.     designed for use by individual callers to a bbs, this format has been
  68.     extended and adapted for inter-bbs message networking as well.
  69.  
  70.     Normally, each bbs participating in a QWK-based network must have its own
  71.     software which will take a message "QWK" packet from the host board and
  72.     toss it the node board's native message base.  The same software would
  73.     normally be used to scan the node's message base for outgoing messages and
  74.     place them into a "REP" packet for uploading back to the host board.
  75.     Since the software operated by the node must interface with the node's own
  76.     message base, each type of bbs generally needs its own specialized QWK-net
  77.     handling software.
  78.  
  79.     There are many boards out there which have QWK-based mail facilities for
  80.     use by its callers, but which do not have specialized software to process
  81.     QWK-net packets.  That's where MNET comes in.  MNET is simply a net-aware
  82.     mail conversion utility that takes QWK packets from the host and converts
  83.     them to REP packets which may be uploaded to the node's standard QWK mail
  84.     facilities.  Similarly, MNET can convert a QWK packet of outgoing mail
  85.     from the node into a REP which can be uploaded to the host.  Since the
  86.     node's standard QWK mail facility does all the interfacing with node's
  87.     message base, no additional specialized software is required.  MNET allows
  88.     any bulletin board with QWK-compatible offline mail capability the ability
  89.     to be a node in a QWK-based message network.
  90.  
  91.     MNET was originally developed for use in conjunction with MAKAI Software's
  92.     Mail Manager +Plus+ QWK mail door for RBBS systems, but it is now in use
  93.     on many different bbs systems around the world.
  94.  
  95.  
  96.     --------------------------------------------------------------------------
  97.                                  GENERAL OVERVIEW
  98.     --------------------------------------------------------------------------
  99.  
  100.     Let's assign some sample packet names to use for purposes of illustration:
  101.  
  102.       - You log onto the host's board and download a "net status" packet
  103.         called "HOST.QWK".
  104.  
  105.       - You are networking the "SPECIAL" conference, which is area #3 on
  106.         host's system.
  107.  
  108.       - The REP packets that you send to your host will be named "HOST.REP".
  109.  
  110.       - Your board uses the filenames "NODE.QWK" and "NODE.REP" for QWK and
  111.         REP packets transferred.
  112.  
  113.       - The networked "SPECIAL" conference is area #15 on your system.
  114.                                 MNET v2.10 QWK-Network File Conversion Utility
  115.                                                                     - Page 3 -
  116.  
  117.     The MNET.EXE utility will allow you to transfer the messages contained in
  118.     HOST.QWK into your system, and to convert any outbound messages from your
  119.     system into a HOST.REP file that you can upload to the host.
  120.  
  121.     All the fun part of pulling this off is on your end:
  122.  
  123.     1) You fire up the your bbs QWK mail facilities and extract a QWK packet
  124.        of the messages to be exported.  Using the naming conventions from
  125.        above, you would create a packet named NODE.QWK.
  126.  
  127.     2) The host system can't do anything with NODE.QWK, so you use our MNET
  128.        utility to convert it to HOST.REP.
  129.  
  130.     3) Call up the host board, extract and download a new HOST.QWK and upload
  131.        your HOST.REP reply packet.  Depending on how your host is set up, you
  132.        may need to call in under a special user name which the host sets up
  133.        for you in order to grant you net access.  Also note that, depending on
  134.        how your host's system handles net packets, it may be necessary for you
  135.        to reset message pointers after you upload your REP so as not to
  136.        receive those same messages back in your next QWK packet.  Check with
  137.        your host sysop on how this must be handled on that particular system.
  138.  
  139.     4) Back at your end, you use MNET to convert HOST.QWK that you just
  140.        downloaded to NODE.REP.
  141.  
  142.     5) Go back into the QWK mail facilities for your board and upload the
  143.        newly imported messages as NODE.REP.  Depending on your system, you may
  144.        need to update your message pointers after uploading the rep so as not
  145.        to export those same messages in your next packet.
  146.  
  147.     6) Repeat unto infinity.
  148.  
  149.     Now, you would probably imbellish this to make a call that does all of
  150.     this at once (i.e. - Send up HOST.REP and download HOST.QWK in the same
  151.     session).
  152.  
  153.     Graphically, this might look like:
  154.                                 MNET v2.10 QWK-Network File Conversion Utility
  155.